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This paper gives an overview of the HENSHIN solution to the Hello World case study of the Trans- 
formation Tool Contest 2011, intended to show basic language concepts and constructs. 

1 Introduction 

In the modeling community, the Eclipse Modeling Framework (EMF) [6] has evolved to a well-known 
and widely used technology. It is obviously promising to provide model transformation support for EMF. 
With Henshin ffl|3]|, a declarative transformation language and tool environment for EMF models is 
available. Particularly, EMF models are transformed directly, called in-place, without the need of back 
and forth conversions and copies. HENSHIN supports the transformation of EMF models by generated 
code as well as those created dynamically. Its transformation concepts base on the well-founded theory 
of algebraic graph transformation with pattern-based rules as main artifacts, extended by nestable appli- 
cation conditions and attribute computation. Moreover, the HENSHIN transformation language allows to 
structure rules by means of nestable transformation units with well-defined operational semantics. Ad- 
ditionally, a state space generator supports reasoning by model checking which is, however, not further 
investigated here. The export of rules to AGG Q is possible as well, where analysis concerning con- 
flicts and dependencies as well as termination may take place. Graphical editors support the definition 
of Henshin model transformations in several fashions. 

In the following, Sec.[2]outlines Henshin's transformation language and concepts. A representative 
subset of the HelloWorld solution is presented in Sec.[3]followed by a conclusion. 

2 Henshin Transformation in a Nutshell 

The Henshin transformation meta-model is an EMF model itself. Its main artifacts are rules essentially 
consisting of two graphs, a left-hand side (LHS) and a right-hand side (RHS), specifying model patterns 
on abstract syntax level. The LHS describes the pattern to be found while the RHS describes the resulting 
pattern. Nodes and edges occurring in the LHS or RHS only, are deleted or created, respectively. Node 
mappings between LHS and RHS declare identity, i.e., related nodes and edges are preserved. Rules 
may also be equipped with positive and negative application conditions (PACs and NACs) being graph 
patterns again which confine the match furthermore. Their true power emerges in combination with 
logical formulas (AND, OR, NOT) and with nesting even allowing to define conditions over conditions. 
Moreover, in the context of rules attribute conditions can be defined whose expressions are evaluated by 
a JavaScript engine at runtime. 

The order of rule applications can be controlled by transformation units, short units, providing a well- 
defined operational semantics. Units may contain other units including rules which can be considered as 
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atomic units corresponding to their single application. HENSHIN offers a predefined set of units: Inde- 
pendentUnits provide a non-deterministic unit choice, PriorityUnits specify priorities in which contained 
units are chosen to be applied, a counted application is provided by the CountedUnit at which a count 
value of -1 specifies a loop, i.e., "as often as possible", SequentialUnits apply rules in a sequential order 
and perform a rollback if any of its rules cannot be applied, and ConditionalUnits allow to specify an 
if condition with a corresponding then and else part. Last but not least, AmalgamationUnits are special 
units expressing forall-operations on recurring model patterns. Here, a kernel rule is applied once with a 
number of multi rules being applied as often as possible taking the match of the kernel rule into account. 

The object flow can be specified along the control flow using parameters and parameter mappings. 
They may pass objects and values from one unit to another one in order to pre-define (partial) matches. 

Currently three different editors provide three different views on HENSHIN transformation models. 
A tree-based editor provides a very low-level view on the internal model structure, while two other 
editors offer a more sophisticated graph-like visualization. One visual editor, in the following called 
complex editor, shows LHS, RHS and application conditions in separate views and is particularly suit- 
able for complex transformation systems with arbitrary control and object flows. In contrast, the visual 
integrated-rule editor shows rules in an integrated manner in a single view utilizing stereotypes to denote 
creation, deletion and preservation. This editor is more suitable for simple rules. Note, the figures in this 
paper show one or the other visual representation according to its appropriateness in each individual case. 

The application of rules and transformation units on arbitrary models can be triggered by a wizard 
on the one hand. On the other hand, HENSHIN has been designed in a modular way with an independent 
transformation engine such that it can be freely integrated into any Java project relying on EMF models. 
Flexible properties allow to switch between injective (default) and non-injective matching. Dedicated 
classes, RuleApplication and UnitApplication, provide appropriate methods to select and apply 
rules and transformation units, respectively. 

3 Case Study Tasks Solved by Henshin 

In the following a representative subset of the complete solution of the Hello World challenge [ 5 j is pre- 
sented while a full listing is given in Appendix [A] Each transformation is triggered via Java source code. 
In order to display/persist a transformation's outcome, appropriate rules or units contain a parameter, 
e.g., result or counter, which is fetched on code level (see Appendix|B]). Furthermore, in some cases 
we exploit a HENSHIN self-contained helper structure called trace model in order to keep track of the 
transformation process. This model consists of a class Trace which might be connected to any EMF 
object by two references, source and target. 

Task 1: Hello World! Figure [T] shows the solutions for each of the tree subtasks of the first Hello 
World! task by means of the integrated-rule editor. Each rule is presented as rounded rectangle with 
its name at the top and its graph structure contained. Stereotypes denote related nodes and edges to 
be created, deleted or preserved. Note, in the editor undefined stereotypes default to preserve. 
However, it is conceivable to omit that stereotype at all in the future. 

In the left of Fig. [T] rule CreateSimple consists of a node of type Greeting to be created which 
is assigned to the parameter result. The value of its attribute text is also set to the string "Hello 
World". Rule CreatedExtended, located in the center of Fig. [T] creates a more complex greetings 
structure by introducing a number of nodes and edges. The model-to-text transformation subtask is repre- 
sented by the rule M2T which preserves a given greetings structure while creating a new : StringResult 
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object. In addition, two parameters, preTxt and postTxt, are utilized to fetch the corresponding at- 
tribute values of the matched objects :GreetingMessage and : Person in order to participate in the 
attribute computation for the : StringResult object. 



=^ CreateSimple 



«create» 
resultGreetinq 



a text="Hello World' 



=^ CreateExtended 



«create» 
greetingMess 



«create» 
resultGreetinq 



create» 
person 



«create» 
:GreetinqMessaqe 



<=> text="Hello" 



«create» 
:Person 



name="TTC Participants" 



M2T 



«preserve> 
:Greetinq 



«preserve» 
greetingMessage 



«create» 

result:StrinqResult 



result=preTxt ■ 



«preserve» 
:GreetinqMessaqe 



text=preTxt 



person 



«preserve» 



«preserve» 
:Person 



name=postTxt 



postTxt 



Figure 1 : Tree rules concerning the Hello World! subtasks shown in an integrated manner. 



Task 2: Count Matches. All related subtasks are implemented by structurally similar sequential units 
while one, CountDanglingEdges, is exemplarily illustrated in Fig. [2] by means of the complex editor. 
Actually, this figure is a compositions of different views of the complex editor in favor of space savings. 
The control flow is shown in the lower right where at first rule CreateCounterObject is applied. It 
creates an initial counter: IntResult object used for counting and used as return value with the help 
of parameter counter. Note that the same rule is reused by all subtasks. Afterwards, contained in a 
counted unit CountDanglingEdgesXoop, rule CountDanglingEdges_Increase is applied as often 
as possible performing the actual counting. Its LHS, RHS (upper right) and NACs (left) are shown in 
Fig. [2] as well. Identical nodes are indicated by numbers in brackets. This rule matches the : IntResult 
object and an : Edge object which has not been marked by a : Trace object yet and which has no source 
or no target, including not having either. Each rule application increases the value of the attribute result 
by one and marks the edge as being visited by creating and connecting a : Trace object. 
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Figure 2: Overview of the sequential unit CountDanglingEdges (bottom right) and details of the rule 
CountDanglingEdges.Increase with LHS, RHS and three NACs composed by a logic formula. 



Task 3: Reverse Edges. This task is solved by applying the rule ReverseOneEdge (cf. Fig. [3]> in a 
loop as often as possible. : Edge and : Node objects are preserved during the transformation while two 
references are created and two others are deleted. In addition, a : Trace object is created as marker in 
combination with the NAC "Already reversed" which forbids such a marker to exist in the given context. 
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Another solution would have been using an amalgamation unit. In this case, the kernel rule would be 
empty. The multi rule would be similar to the rule ReverseOneEdge but without the NAC and the trace 
objects, since a single application of an amalgamation unit matches each multi rule as often as possible 
and performs all those transformations in parallel. See Task 5 for more details on amalgamation units. 



=^ ReverseOneEdge 




« preserve 
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trg 




src 
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Figure 3: Rule ReverseOneEdge for reversing an edge's direction. 



Task 4: Simple Migration. The solution for this task uses techniques already known. At first the rule 
CreateNewGraph creates a new Graph object as initial root object. Afterwards, one rule (MigrateNode) 
migrating a single node is applied in a loop and subsequently one rule (MigrateEdge) migrating an edge 
is applied in a loop too. Again, : Trace objects mark those elements already translated. 

There are a number of alternative ways to realize this task. For example, one could use an amalga- 
mation unit creating a : Graph object in the kernel rule and performing the node migration in a multi 
rule without the need of trace objects. Another amalgamation unit could realize the migration of edges. 
Then, the whole migration would require the sequential application of both units. 

The solution for the extended task is actually realized with the help of an amalgamation unit. We 
skip this here and rather refer to the following task using this special kind of unit as well. 



Task 5: Delete Node and its Incident Edges. Both deletion subtasks have been solved using amal- 
gamation units. Figure [4] shows all parts of the amalgamation unit DeleteNodeNlSimple realizing 
the core task. The left rule, DeleteNodeNl, serves as kernel rule and matches a : Graph object and 
a connected :Node object named "nl". Its RHS points out that the node is to be deleted. The rules 
DeletelncomingRef and DeleteOutgoingRef serve as multi rules. Their names indicate already, that 
they delete an incoming and an outgoing reference, respectively. Each multi rule is defined in the context 
of its kernel rule denoted by the parts grayed out in the LHS and RHS of the multi rules, while the parts 
belonging to the multi rule are illustrated by double rectangles. An application of the amalgamation unit 
leads to a single match of the kernel rule and all possible matches of the multi rules taking the match of 
the kernel rule into account. For further information on amalgamation units please refer to 0. 
The extended task is realized in a similar way and thus not shown here (see Appendix). 



Task 6: Insert Transitive Edges. The last task is solved by the rule Insert TransitiveEdge applied 
in a loop to create a single transitive edge for an already existing connection between three Node objects. 
This is quite analogous to what has been explained above and therefore not presented in detail here. 
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Figure 4: Amalgamation unit DeleteNodeNlSimple consisting of one kernel and two multi rules. 



4 Conclusion 

This paper presents the solution of the Hello World challenge [5] implemented by Henshin. All tasks 
including all optional tasks are solved. The implementation is made available under SHARE 0. 

The solution is particularly characterized by a visual transformation language, pattern-based rules 
and the capability of defining control and object flows. Three different graphical editors support the 
creation and editing of HENSHIN transformation systems, each one with its assets and drawbacks. How- 
ever, each editor provides a visualization more or less close to the underlying transformation model. For 
example, the creation of more than two application conditions leads to quite some nesting due to binary 
formulas as shown in Fig. [2] Moreover, control and object flows are often not easy to grasp. To over- 
come these issues a more adequate representation is desirable. The question arises whether an integrated 
visualization of rules and control flow (and object flow) or a separate visualization is more appropriate. 
Whatever decision will be made, the current major shortcomings of HENSHIN, understandability and 
conciseness, need to be addressed in further developments. The application of each transformation is 
currently triggered by dedicated source code, although a wizard is available as well. However, transfor- 
mation engine configurations, e.g., switch to non-injective matching, require the use of code yet. Besides 
the scope of solutions for this task, the performance of HENSHIN behaves quite well. Additional fea- 
tures to be possibly integrated are attribute computations using OCL expressions, path expressions, and 
untyped nodes and edges representing elements of arbitrary type improving the understanding of rules. 
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A All Solutions 



In the following the solutions to all tasks are given. If appropriate, rules are shown using the integrated- 
rule editor manually composed with an overview of belonging units. More complex rules are rather given 
by means of the complex-rule editor showing LHS, RHS and application conditions separately. 

A.l Task 1 

1 . Constant transformation. 

2. Constant transformation that creates a model with references. 

3. Model-to-text transformation. 



=^ CreateSimple 



«create» 

resultGreetinq 

a text="Hello World" 



Figure 5: Task 1.1 - Rule CreateSimple. 
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«create» 4 
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«create» 
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Figure 6: Task 1.2 - Rule CreateExtended. 



=> M2T 



«preserve» 
:Greetinq 
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Figure 7: Task 1.3 - Rule M2T. 
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A.2 Task 2 

Model query that counts the number of . . . 

1 . nodes in a graph. 

2. looping edges. 

3. isolated nodes. 

4. matches of a circle consisting of three nodes. 

5. dangling edges. 

Each task is solved utilizing a sequential unit containing the rule CreateCounterObject at first and 
subsequently containing a counted unit with another rule contained. While all solutions to task 2 reuse 
the same rule CreateCounterObject, the actual counting is performed in the rule contained in the 
respective counted unit. The counted units have a count value of -1 and thus force the contained rule to 
be applied in a loop, i.e., as often as possible. 



=^ CreateCounterObject 




«create» 

countenlntResult 




<=> result=0 









Figure 8: Rule CreateCounterObject 
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Figure 9: Task 2.1 - Sequential unit CountNodes and details of the rule CountNodes.Increase. 
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Figure 10: Task 2.2 - Sequential unit CountLoopingEdges and details of the rule 
CountLoopingEdges.Increase. 
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Figure 11: Task 2.3 - Sequential unit CountlsolatedNodes and details of the rule 
Count I solatedNodes.Incr ease. 
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Figure 12: Task 2.4 - Sequential unit CountCircles and details of the rule CountCircles_Increase. 
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Figure 13: Task 2.5 - Sequential unit CountDanglingEdges and details of the rule 
CountDanglingEdges.Increase with LHS, RHS and three NACs composed by a logic formula. 



A.3 Task 3 

1 . Reversing all edges. 

The solution to this task is characterized by a counted unit with count=- 1 applying rule Rever seOneEdge 
in a loop, i.e., as often as possible. 
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Figure 14: Task 3.1 - Counted unit ReverseEdges and details of the rule ReverseOneEdge. 



262 Saying Hello World with Henshin 



A.4 Task 4 

1. Simple migration of a graph conforming to one metamodel (graphl) to a graph conforming to a 
second metamodel (graph2). 

2. Topology-changing migration of a graph conforming to one metamodel (graphl) to a graph con- 
forming to a second metamodel (graph3). 



' ^ SimpleMigration 

CreateNewGraph 
" xfl MigrateNodes 

rf MigrateNode 
^ MigrateEdges 
. MigrateEdge 
it newGraph 
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a text-n 
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Figure 15: Task 4.1 - Sequential unit SimpleMigration and details of its rules. Within the sequen- 
tial unit, at first a new Graph object is created serving as container for the migrated nodes and edges. 
Afterwards, each node is migrated by rule MigrateNode applied in a loop and then each edge is mi- 
grated by rule MigrateEdge analogously. Please note a current shortcoming of the visualization of 
rules: MigrateNode and MigrateEdge show a number of Node and Edge objects which are, however, 
typed over different metamodels. For example, in MigrateNode the left Node object is typed over the 
source metamodel (graphl) while the right Node object is typed over the target metamodel (graph2). 
We plan to overcome this issue by showing the underlying metamodel's name below each node's name, 
if required. 
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Figure 16: Task 4.2 - Sequential unit SimpleMigrationExt and details of parts of its amalgamation 
unit. The kernel rule SelectNode matches one node and its migrated counterpart node whose edges 
have not been migrated yet (due to NAC AlreadyMigrated) while the multi rule matches each related 
edge and introduces a corresponding linksTo reference in the target model. The RHS of the kernel rule 
marks the node by a Trace object to be completely migrated including its edges . Note, that the rules 
MigrateNode and CreateNewGraph are structurally equal to corresponding rules of Task 4.1, besides 
the fact, that they differ in their underlying metamodel. 
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A.5 Task 5 

1. Deletion of a node with name "nl". 

2. Deletion of a node with name "nl" and all its incident edges. 

Each subtask is solved by applying a single amalgamation unit. Note, that the same rule DeleteNodeNl 
is reused by both amalgamation units shown below. 



' DeleteNodeNlSimple 

j KERNEL: DeleteNodeNl 
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Figure 17: Task 5.1 - Amalgamation unit DeleteNodeNlSimple and details of its rules. 
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- DeleteNodeNlWithAIIEdges 
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Figure 18: Task 5.2 - Amalgamation unit DeleteNodeNlWithAIIEdges and details of its rules. 
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A.6 Task 6 

The solution to this task turned out to be quite simple: A single rule needs to be called in a loop only. 
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Figure 19: Task 6.1 - Counted unit IntertTransitiveEdges and details of its rule 
InsertTransitiveEdge. 



B Java Code of the Transformation Application 

This section shows the code to trigger the applications of all transformations. Each task is represented by 
a class containing related code. Note that the classes contain some redundant code in order to allow the 
reader to concentrate on certain parts without hiding functionality by inheritance and call hierarchies. 

Listing 1 : Abstract transformation base class 
i package de . unimarburg . swt . ttc20 1 1 ; 



3 import 

4 import 

5 import 

6 

7 import 

8 import 

9 import 

10 import 

11 import 

12 import 
n import 
M import 

15 import 

16 import 
n import 

18 
19 
20 
21 

22 



Java . 
java . 
j av a . u t 



io . File ; 
io . IOException ; 



/ * * 

* This 

* used 

* c la s 



1 . HashMap ; 



org . eclipse . emf . common . u t i 1 . URI ; 

org . eclipse . emf. ecore . EObject ; 

org . eclipse . emf. ecore . resource . Resource ; 

org . eclipse . emf. ecore . resource . ResourceSet ; 

org . eclipse .emf. ecore . resource . impl . ResourceSetlmpl ; 

org . eclipse . emf. ecore . xmi . XMIResource ; 

org . eclipse . emf. ecore . xmi . impl . EcoreResourceFactorylmpl ; 

org . eclipse . emf. ecore . xmi . impl . XMIResourceFactory Impl ; 

org . eclipse . emf. henshin . model . impl . HenshinPackagelmpl ; 

org . eclipse . emf. henshin . model . resource . HenshinResourceFactory 

org . eclipse . emf. henshin . trace . impl . TracePackagelmpl ; 



files contains some general methods and variables 
again and again. All other transformation related 
ses inherit from that to use its given tool set as 
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23 * loading and saving . 

24 * 

25 * ©author Stefan Jurack 

26 * 

27 * / 

28 public abstract class ATrafo { 



29 

30 public static final String MODELS JPATH = "HelloWorld/models/" ; 

31 public static final String HENSHINJWTH = " HelloWorld/henshin/ " ; 

32 public static final String OUTPUTTATH = "HelloWorld/output/" ; 

33 

34 / * * 

35 * The shared resource set for loading XMI files . 

36 */ 

37 protected final ResourceSet resourceSet = new ResourceSetlmpl () ; 

38 

39 / * * 

40 * To be overridden ! 

41 */ 

42 public void start () { 

43 //Prerequisites 

44 initializeFactoriesQ; 

45 // 

46 }// start 

47 

48 / * * 

49 * Loads the model and returns the root element. 

50 * 

51 * @param modelFilePath 

52 * ©return 

53 */ 

54 protected EObject loadModel ( String modelFilePath) { 

55 URI modelUri = URI . createFileURI (new File ( modelFilePath ) 

56 . getAbsolutePath ( ) ) ; 

57 Resource modelResource = resourceSet . getResource ( 

58 modelUri, true); 

59 if ( modelResource . isLoaded () ) { 

60 / * 

61 * make sure that we work with a virgin instance 

62 * of the model 

63 */ 

64 modelResource . unload () ; 

65 

66 try { 

67 modelResource . lo ad ( null ) ; 

68 } catch (IOException e) { 

69 }// try catch 

70 }// if 

71 return modelResource . getContents (). get (0) ; 

72 }// loadModel 

73 

74 / * * 
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75 * Saves the content of the given <code>root </code> 

76 * {@link EObject} to the specified file path. 

77 * 

78 * @param filename 

79 * @param root 

80 */ 

si protected void saveModel ( String filename, EObject root) { 

82 URI modelUri = URI . createFileURI (new F i 1 e ( OUTPUT JATH 

83 + filename). getAbsolutePath()); 

84 Resource res = re s ource S et . ere ateRe source ( modelUri ) ; 

85 HashMap<S tring , Object> opts = new HashMap<S tring , 

Object >() ; 

se opts . put (XMIResource . OPTION JSCHEMAXOCATION , true); 

87 try { 

88 res . getContents (). add ( root ) ; 

89 res . save ( opts ) ; 

so } catch (IOException e) { 

91 e . printStackTrace () ; 

92 }// try catch 

93 }// saveModel 

94 

95 / * * 

96 * Initializes related factories and packages. 

97 */ 

98 protected void initializeFactories () { 

99 Resource . Factory . Registry .INSTANCE 

100 .getExtensionToFactoryMap().put("ecore", 

101 new 

EcoreResourceFactory Impl () ) ; 

102 Resource . Factory . Registry .INSTANCE 

103 . getExtensionToFactoryMap () . put ( "xmi " , 

104 new 

XMIResourceFactorylmpl () ) ; 

105 Resource . Factory . Registry .INSTANCE 

106 . getExtensionToFactoryMap (). put ("henshin", 

107 new 

HenshinResourceFactory ()) ; 

108 

109 HenshinPackagelmpl . i n i t ( ) ; 

no TracePackagelmpl . init () ; 

in }// initializeFactories 

112 



in } // class 

Listing 2: Starter for the transformations 
i package de . unimarburg . swt . ttc20 1 1 ; 

2 

3 public class Starter { 

4 

5 public static void main( String args[]) { 

6 ATrafo trafo ; 
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7 // 

8 

9 trafo = new HelloWorldTrafo () ; 

10 trafo. start (); 

11 // 

12 trafo = new CountMatchesTrafo () ; 
n trafo . start () ; 

14 // 

15 trafo = new ReverseEdges Trafo () ; 

16 trafo . start () ; 

17 // 

18 trafo = new SimpleMigrationsTrafo () ; 

19 trafo. start (); 

20 // 

21 trafo = new DeleteNodeTrafo () ; 

22 trafo. start (); 

23 // 

24 t r a f o = new InsertTransitiveEdgesTrafo () ; 

25 trafo. start (); 

26 

27 }// main 

2<S 



29 }// class 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 



Listing 3: Hello World transformation class 
package de . unimarburg . swt . ttc201 1 ; 

import org . eclipse . emf . ecore . EObject ; 

import org . eclipse . emf . hens h in . common . u t i 1 . Emf Graph ; 

import org . eclipse . emf. henshin . interpreter . Emf Engine ; 

import org . eclipse . emf. henshin . interpreter . UnitApplication ; 

import org . eclipse . emf. henshin . model . Rule ; 

import org . eclipse . emf. henshin . model . TransformationSystem ; 



This class performs 
HelloWorld case at 
Task 1 



transformations related to the 
the TTC 2011. <br> 



* ©author Stefan Jurack 

*/ 

public final class HelloWorldTrafo extends ATrafo { 
public static 



public static 



/* * 



final String HENSHIN .HELLOWORLD = HENSHIN J 3 ATH 

+ "helloworld . henshin" ; 
final String HENSHIN JHELLOWORLDJiXT = HENSHIN JPATH 
+ " helloworldext . henshin " ; 
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27 * / 

28 ©Override 

29 public void start () { 

30 super . s t ar t () ; // prerequisites 

31 

32 System . out . println ( "Task 1"); 

33 

34 performHello World () ; 

35 performHello WorldExt () ; 

36 

37 }// start 

38 

39 / * * 

40 * Creates an example "Hello World" instance. 

41 */ 

42 private void performHelloWorld ( ) { 

43 

44 TransformationSystem ts = ( TransformationSystem ) 

loadModel ( HENSHTN JHELLOWORLD ) ; 

45 EmfGraph emf Graph = new EmfGraph (); 

46 EmfEngine engine = new EmfEngine ( emfGraph ) ; 

47 Rule rule = t s . findRuleByName ( " CreateSimple " ) ; 

48 Unit Application unitApp = new Unit Application ( engine , 

49 rule ) ; 

so boolean success = unitApp . execute () ; 

si if ( success ) { 

52 EObject result = (EObject) unitApp 

53 . getParameterValue(" result"); 

54 saveModel ( " HelloWorldSimple . xmi " , result); 

55 } else { 

56 System . err 

57 . pri nt In ("' Hello World' could not 

be applied ! " ) ; 

58 } 

59 }// performHelloWorld 

60 

61 / * * 

62 * Creates an example "Hello World" instance for the 

63 * extended metamodel and subsequently performs a M2T 

64 * transformation on that newly created model. 

65 */ 

66 private void performHelloWorldExt () { 

67 

68 TransformationSystem ts = (TransformationSystem) 

1 o a d M o d e 1 ( HENSHIN_HELLOWORLD JEXT ) ; 

69 EmfGraph emfGraph = new EmfGraph (); 

70 EmfEngine engine = new EmfEngine ( emfGraph ) ; 

71 Rule rulel = t s . findRuleByName (" CreateExtended ") ; 

72 Unit Application unitAppl = new Unit Application ( engine , 

73 rulel); 

74 boolean success = unit App 1 . execute () ; 

75 if(success){ 
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76 EObject result = (EObject) unitAppl 

77 . getParameterValue(" result"); 

78 saveModel ( " HelloWorldExt . xmi " , result); 

79 } else { 

so System . err 

si . println (" 'Hello World Ext' could 

not be applied!"); 

82 return ; 

83 }// if else 

84 

85 / * 

86 * We do now reuse the EmfGraph / Engine for the M2T 

87 * task since then we already have an appropriate 

88 * start graph at hand. 

89 */ 
90 

si Rule rule2 = ts . findRuleByName ( "M2T" ) ; 

92 Unit Application unitApp2 = new Unit Application ( engine , 

93 r u 1 e 2 ) ; 

94 success = unitApp2 . execute () ; 

95 if(success){ 

96 EObject result = (EObject) unitApp2 

97 . getParameterValue(" result"); 

98 saveModel ( " HelloWorldM2T . xmi " , result); 

99 } else { 

100 System . err 

101 . println (" 'Hello World M2T ' could 

not be applied!"); 

102 }// if else 

103 

104 }// performHelloWorldExt 

105 



io6 }/ / class 



Listing 4: Count matches transformation class 
i package de . unimarburg . swt . ttc20 1 1 ; 



3 import org . eclipse . emf. ecore . EObject ; 

4 import org . e c 1 ip s e . emf . henshin . common . u t i 1 . EmfGraph ; 

5 import org . eclipse . emf . henshin . interpreter . EmfEngine ; 

6 import org . eclipse . emf . henshin . interpreter . UnitApplication 

7 import org . eclipse . emf . henshin . model . TransformationSystem ; 

8 import org . eclipse . emf . henshin . model . TransformationUnit ; 



/* * 



This class performs transformations related to the 
HelloWorld task at the TTC 2011. <br> 
Task 2 

©author Stefan Jurack 
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17 */ 

is public class CountMatchesTrafo extends ATrafo { 



19 

20 public static final String INSTANCE GRAPH 1 = MODELS JPATH 

21 + " Graphl . xmi " ; 

22 

23 public static final String HENSHIN.COUNTJVIATCHES = HENSHIN_PATH 

24 + " countMatches . henshin" ; 

25 

26 / * 

27 * ( non— Javadoc ) 

28 * @see de . unimarburg . swt . ttc20 1 1 . ATrafo# s t a r t ( ) 

29 */ 

30 ©Override 

31 public void start () { 

32 super . s t ar t () ; // prerequisites 

33 

34 System . out . println ( "Task 2"); 

35 

36 performCountNumberOfNodes ( ) ; 

37 performCountLoopingEdges () ; 

38 performCountlsolatedNodes () ; 

39 performCountCirclesQ; 

40 performCountDanglingEdges () ; 

41 

42 }// start 

43 

44 private void performCountNumberOfNodes ( ) { 

45 String unitName = " CountNodes " ; 

46 TransformationSystem ts = ( TransformationSystem ) 

1 o a d M o d e 1 ( HENSHIN COUNT JVIATCHES ) ; 

47 EObject rootObject = loadModel (INSTANCE.GRAPHl ) ; 

48 EmfGraph emf Graph = new EmfGraph (); 

49 emf Graph . addRoot(rootObject) ; 

so EmfEngine engine = new EmfEngine ( emfGraph ) ; 

si TransformationUnit unit = t s . findUnitByName ( unitName ) ; 

52 Unit Application unitApp = new Unit Application ( engine , 

53 unit); 

54 boolean success = unitApp . execute () ; 

55 if(success){ 

56 EObject result = (EObject) unitApp 

57 .getParameterValue(" counter " ) ; 

58 saveModel ( unitName + " Result . xmi " , result); 

59 } else { 

60 System . err . println ("' " + unitName 

61 + "' could not be applied!"); 

62 } 

63 }// performCountNumberOfNodes 

64 

65 private void performCountLoopingEdges () { 

66 String unitName = " CountLoopingEdges " ; 
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67 TransformationSystem ts = ( TransformationSystem ) 

1 o a d M o d e 1 ( HENSHIN.COUNTJVIATCHES ) ; 

es EObject rootObject = loadModel (INSTANCE_GRAPH1) ; 

69 EmfGraph emf Graph = new EmfGraph (); 

70 emfGraph . addRoot ( rootObj ect ) ; 

71 EmfEngine engine = new EmfEngine ( emfGraph ) ; 

72 TransformationUnit unit = t s . findUnitByName ( unitName ) ; 

73 UnitApplication unitApp = new Unit Application ( engine , 

74 unit); 

75 boolean success = unitApp . execute () ; 

76 if(success){ 

77 EObject result = (EObject) unitApp 

78 .getParameterValue(" counter" ) ; 

79 saveModel ( unitName + " Result . xmi " , result); 
so } else { 

si System . err . println ("' " + unitName 

82 + "' could not be applied!"); 

83 } 

84 }// performCountLoopingEdges 

85 

86 private void performCountlsolatedNodes ( ) { 

87 String unitName = "CountlsolatedNodes " ; 

88 TransformationSystem ts = (TransformationSystem) 

1 o a d M o d e 1 ( HENSHIN_COUNT_MATCHES ) ; 
EObject rootObject = loadModel (INSTANCE GRAPH 1 ) ; 

90 EmfGraph emfGraph = new EmfGraph (); 

91 emfGraph . addRoot ( rootObj ect ) ; 

92 EmfEngine engine = new EmfEngine ( emfGraph ) ; 

93 TransformationUnit unit = t s . findUnitByName ( unitName ) ; 

94 UnitApplication unitApp = new Unit Application ( engine , 

95 unit); 

96 boolean success = unitApp . execute () ; 

97 if(success){ 

98 EObject result = (EObject) unitApp 

99 .getParameterValue(" counter" ) ; 

100 saveModel ( unitName + " Result . xmi " , result); 

101 } else { 

102 System . err . println ("' " + unitName 

103 + "' could not be applied!"); 

104 } 

105 }// performCountlsolatedNodes 

106 

107 private void performCountCircles () { 

108 String unitName = " CountCir cles " ; 

109 TransformationSystem ts = (TransformationSystem) 

1 o a d M o d e 1 ( HENSHIN.COUNT JVlATCHES ) ; 

no EObject rootObject = loadModel (INSTANCE GRAPH 1) ; 

in EmfGraph emfGraph = new EmfGraph (); 

112 emfGraph . addRoot( rootObject) ; 

113 EmfEngine engine = new EmfEngine ( emfGraph ) ; 

114 TransformationUnit unit = t s . findUnitByName ( unitName ) ; 
us UnitApplication unitApp = new Unit Application ( engine , 
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ii6 unit ) ; 

in boolean success = unitApp . execute () ; 

118 if ( success ) { 

119 EObject result = (EObject) unitApp 

120 .getParameterValue(" counter" ) ; 

121 saveModel ( unitName + " Result . xmi " , result); 

122 } else { 

123 System . err . println ("' " + unitName 

124 + "' could not be applied!"); 

125 } 

126 }// performCountCircles 

127 

128 private void performCountDanglingEdges ( ) { 

129 String unitName = " CountDanglingEdges " ; 

130 TransformationSystem ts = ( TransformationSystem ) 

1 o a d M o d e 1 ( HENSHIN_COUNT_MATCHES ) ; 

131 EObject rootObject = loadModel (INSTANCE.GRAPHl ) ; 

132 EmfGraph emf Graph = new EmfGraph (); 

133 emf Graph . addRoot( rootObject) ; 

134 EmfEngine engine = new EmfEngine ( emfGraph ) ; 

135 TransformationUnit unit = t s . findUnitByName ( unitName ) ; 

136 UnitApplication unitApp = new Unit Application ( engine , 

137 unit ) ; 

138 boolean success = unitApp . execute () ; 

139 if(success){ 

wo EObject result = (EObject) unitApp 

mi .getParameterValue(" counter" ) ; 

142 saveModel ( unitName + " Result . xmi " , result); 

143 } else { 

144 System . err . println ("' " + unitName 

145 + "' could not be applied!"); 

146 } 

147 }// performCountDanglingEdges 

148 



149 }/ / class 



Listing 5: Reverse edges transformation class 
i package de . unimarburg . swt . ttc20 1 1 ; 



import org . eclipse . emf. ecore . EObject ; 

import org . eclipse . emf . henshin . common . u t i 1 . EmfGraph ; 

import org . eclipse . emf. henshin . interpreter . EmfEngine ; 

import org . eclipse . emf. henshin . interpreter . UnitApplication ; 

import org . eclipse . emf. henshin . model . TransformationSystem ; 

import org . eclipse . emf. henshin . model . TransformationUnit ; 



/ * > 
* 



This class performs 
HelloWorld task at 
Task 3 



transformations related 
the TTC 2011.<br> 



to the 
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15 * ©author Stefan Jurack 

16 * 

17 */ 

is public class ReverseEdgesTrafo extends ATrafo { 



19 

20 public static final String INSTANCE_GRAPH 1 = MODELS-PATH 

21 + " Graphl . xmi " ; 

22 

23 public static final String HENSHIN REVERSE J3DGES = HENSHINJATH 

24 + "reverseEdges . henshin" ; 

25 

26 ©Override 

27 public void start () { 

28 super . s t ar t () ; // prerequisites 

29 

30 System . out . println ( "Task 3"); 

31 

32 performReverseEdges ( ) ; 

33 }// start 

34 

35 private void performReverseEdges ( ) { 

36 String unitName = "ReverseEdges"; 

37 TransformationSystem ts = ( TransformationSystem ) 

loadModel ( HENSHIN _REVERSE_EDGES ) ; 

38 EObject rootObject = loadModel (INSTANCE GRAPH 1 ) ; 

39 EmfGraph emf Graph = new EmfGraph (); 

40 emfGraph . addRoot ( rootObj ect ) ; 

41 EmfEngine engine = new EmfEngine ( emfGraph ) ; 

42 TransformationUnit unit = t s . findUnitByName ( unitName ) ; 

43 UnitApplication unitApp = new Unit Application ( engine , 

44 unit); 

45 boolean success = unitApp . execute () ; 

46 if(success){ 

47 saveModel ( unitName + " Result . xmi " , rootObject); 

48 } else { 

49 System . err . println ("' " + unitName 

so + "' could not be applied!"); 

si }// if else 

52 }// performReverseEdges 

53 



54 }// class 



Listing 6: Simple migrations transformation class 
package de . unimarburg . swt . ttc201 1 ; 



3 import org 

4 import org 

5 import org 

6 import org 

7 import org 

8 import org 



eclipse . emf. ecore . EObject ; 

eclipse . emf . henshin . common . u t i 1 . EmfGraph ; 

eclipse .emf. henshin .common, util . TransformationOptions 

eclipse . emf. henshin . interpreter . EmfEngine ; 

eclipse . emf. henshin . interpreter . UnitApplication ; 

eclipse . emf. henshin . model . TransformationSystem ; 
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9 import org . eclipse . emf. henshin . model . TransformationUnit ; 

10 

n /* * 

12 * This class performs transformations related to the 
is * HelloWorld task at the TTC 2011. <br> 

14 * Task 4 

15 * 

16 * ©author Stefan Jurack 

17 * 

18 * I 

is public class SimpleMigrationsTrafo extends ATrafo { 



20 

21 public static final String INSTANCE.GRAPH1 = MODELS .PATH 

22 + " Graphl . xmi " ; 

23 

24 public static final String HENSHIN .SIMPLE JV1IGRATION = HENSHIN .PATH 

25 + " simpleMigration . henshin" ; 

26 public static final String HENSHIN _SIMPLE_MIGRATION_EXT = 

HENSHIN JATH 

27 + " s impleMigrat ionExt . henshin " ; 

28 

29 ©Override 

30 public void start () { 

31 super . s t ar t () ; // prerequisites 

32 

33 System . out . println ( "Task 4"); 

34 

35 performSimpleMigration () ; 

36 performs impleMigrationExt ( ) ; 

37 }// start 

38 

39 private void performSimpleMigration () { 

40 String unitName = "SimpleMigration"; 

41 TransformationSystem ts = ( TransformationSystem ) 

1 o a d M o d e 1 ( HEN SHIN .SIMPLE JVIIGRATION ) ; 

42 EObject rootObject = loadModel (INSTANCE_GRAPH1) ; 

43 EmfGraph emf Graph = new EmfGraph (); 

44 emfGraph . addRoot ( rootObj ect ) ; 

45 EmfEngine engine = new EmfEngine ( emfGraph ) ; 

46 

47 / * 

48 * Note, that we set matching to be "non— inj ecti ve " 

49 * here . Thus , we can migrate Edges having equal 

so * source and target nodes. Alternatively , we just 

si * could have added one additional rule dealing with 

52 * this special case. 

53 */ 

54 TransformationOptions options = new 

TransformationOptions () ; 

55 options . setlnj ecti ve ( false ) ; 

56 engine. setOptions(options); 

57 
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58 TransformationUnit unit = t s . findUnitByName ( unitName ) ; 

59 Unit Application unitApp = new Unit Application ( engine , 

60 unit); 

61 boolean success = unitApp . execute () ; 

62 if(success){ 

63 EObject result = (EObject) unitApp 

64 . getParameterValue ( "newGraph" ) ; 

65 saveModel ( unitName + " Result . xmi " , result); 

66 } else { 

67 System . err . println ("' " + unitName 

68 + "' could not be applied!"); 
} 

70 }// performSimpleMigration 

71 

72 private void performSimpleMigrationExt () { 

73 String unitName = " SimpleMigrationExt " ; 

74 TransformationSystem ts = ( TransformationSystem ) 

loadModel ( HENSHIN_SIMPLE_MIGRATION_EXT ) ; 

75 EObject rootObject = loadModel (INSTANCE.GRAPHl ) ; 

76 EmfGraph emf Graph = new EmfGraph (); 

77 emf Graph . addRoot( rootObject) ; 

78 EmfEngine engine = new EmfEngine ( emfGraph ) ; 

79 

80 / * 

si * Note, that we set matching to be "non— i nj e c t i v e " 

82 * here . Thus , we can migrate Edges having equal 

83 * source and target nodes. Alternatively , we just 

84 * could have added one additional rule dealing with 

85 * this special case. 

86 */ 

87 TransformationOptions options = new 

TransformationOptions () ; 

88 options . setlnj ective ( false ) ; 

89 engine. setOptions(options); 

90 

si TransformationUnit unit = t s . findUnitByName ( unitName ) ; 

92 Unit Application unitApp = new Unit Application ( engine , 

93 unit); 

94 boolean success = unitApp . execute () ; 

95 if(success){ 

96 EObject result = (EObject) unitApp 

97 . getParameterValue ( "newGraph" ) ; 

98 saveModel ( unitName + " Result . xmi " , result); 

99 } else { 

100 System . err . println ("' " + unitName 

101 + "' could not be applied!"); 

102 } 

103 }// performSimpleMigrationExt 

104 



105 } / / class 



278 



Saying Hello World with Henshin 



Listing 7: Delete nodes transformation class 



3 
4 
5 
6 
7 
8 
9 

10 
1 1 
12 
13 
14 
15 
16 
17 
IS 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 

40 
41 
42 
43 
44 
45 
46 
47 
48 
49 



package de . unimarburg . swt . ttc201 1 ; 

import org . eclipse . emf . ecore . EObject ; 

import org . eclipse . emf . henshin . common . u t i 1 . Emf Graph ; 

import org . eclipse . emf . henshin . common . util . TransformationOptions ; 

import org . eclipse . emf. henshin . interpreter . Emf Engine ; 

import org . eclipse . emf. henshin . interpreter . UnitApplication ; 

import org . eclipse . emf. henshin . model . TransformationSystem ; 

import org . eclipse . emf. henshin . model . TransformationUnit ; 

/ * * 

* This class performs transformations related to the 

* HelloWorld task at the TTC 2011. <br> 

* Task 5 

* 

* ©author Stefan Jurack 

* 

*/ 

public class DeleteNodeTrafo extends ATrafo { 

public static final String INSTANCE.GRAPHl = MODELS _PATH 
+ " Graphl . xmi " ; 

public static final String HENSHINJDELETEJNODE = HENSHIN JPATH 
+ " deleteNode . henshin" ; 

©Override 

public void start () { 

super . s t ar t () ; // prerequisites 

System . out . println ( "Task 5"); 



performDeleteNode () ; 
performDeleteNodeWithAHEdges () ; 
}// start 

private void performDeleteNode ( ) { 

String unitName = " DeleteNodeNlSimple " ; 
TransformationSystem ts = (TransformationSystem) 

1 o a d M o d e 1 ( HENSHIN JDELETEJVODE ) ; 
EObject rootObject = loadModel (INSTANCE.GRAPHl ) ; 
EmfGraph emfGraph = new EmfGraph (); 
emf Graph . addRoot(rootObject) ; 
EmfEngine engine = new EmfEngine ( emfGraph ) ; 
TransformationUnit unit = t s . findUnitByName ( unitName ) ; 
UnitApplication unitApp = new Unit Application ( engine , 
unit ) ; 

boolean success = unitApp . execute () ; 
if ( success ) { 

saveModel ( unitName + " Result . xmi " , rootObject) 
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so } else { 

51 System . err . println ("' " + unitName 

52 + "' could not be applied!"); 

53 } / / i f e 1 s e 

54 }// performDeleteNode 

55 

56 private void performDeleteNodeWithAHEdges ( ) { 

57 String unitName = " DeleteNodeNlWithAllEdges " ; 

58 TransformationSystem ts = ( TransformationSystem ) 

loadModel ( HENSHIN JDELETE_NODE ) ; 

so EObject rootObject = loadModel (INSTANCE_GRAPH1 ) ; 

60 EmfGraph emf Graph = new EmfGraph (); 

61 emfGraph . addRoot ( rootObj ect ) ; 

62 EmfEngine engine = new EmfEngine ( emfGraph ) ; 

63 

64 / * 

65 * Note that we use non— i nj e c t i v e matching here. 

66 * This is not required for "nl" as there are no 

67 * cyclic edges, but in general this should be 

68 * enabled for such cases (or alternatively 

69 * considered during rule creation). 

70 */ 

71 TransformationOptions options = new 

TransformationOptions () ; 

72 options . setlnj ective ( false ) ; 

73 engine. setOptions(options); 

74 

75 TransformationUnit unit = t s . findUnitByName ( unitName ) ; 

76 UnitApplication unitApp = new Unit Application ( engine , 

77 unit); 

78 boolean success = unitApp . execute () ; 

79 if(success){ 

so saveModel ( unitName + " Result . xmi " , rootObject); 

si } else { 

82 System . err . println ("' " + unitName 

83 + "' could not be applied!"); 

84 }// if else 

85 }// performDeleteNodeWithAHEdges 

86 

87 }// class 

Listing 8: Insert transitive edges transformation class 
i package de . unimarburg . swt . ttc20 1 1 ; 

2 

3 import org . eclipse . emf . ecore . EObject ; 

4 import org . e c lip s e . emf . henshin . common . u t i 1 . EmfGraph ; 

5 import org . eclipse . emf . henshin . interpreter . EmfEngine ; 

6 import org . eclipse . emf . henshin . interpreter . UnitApplication ; 

7 import org . eclipse . emf . henshin . model . TransformationSystem ; 

8 import org . eclipse . emf . henshin . model . TransformationUnit ; 

9 
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10 / * * 

11 * This class performs transformations related to the 

12 * HelloWorld task at the TTC 2011. <br> 
B * Task 6 

14 * 

is * ©author Stefan Jurack 

16 * 

17 */ 

is public class InsertTransitiveEdgesTrafo extends ATrafo { 



19 

20 public static final String INSTANCE_GRAPH 1 = MODELS _PATH 

21 + " Graphl . xmi " ; 

22 

23 public static final String HENSHIN JNSERT_EDGES = HENSHIN_PATH 

24 + " insertTransitiveEdges . henshin" ; 

25 

26 ©Override 

27 public void start () { 

28 super . s t ar t () ; // prerequisites 

29 

30 System . out . println ( "Task 6"); 

31 

32 performlnsertTransitiveEdges (); 

33 } / / s t a r t 

34 

35 private void performlnsertTransitiveEdges () { 

36 String unitName = "InsertTransitiveEdges"; 

37 TransformationSystem ts = ( TransformationSystem ) 

loadModel ( HENSHIN JNSERT .EDGES ) ; 

ss EObject rootObject = loadModel (INSTANCE.GRAPHl ) ; 

39 EmfGraph emf Graph = new EmfGraph (); 

40 emf Graph . addRoot( rootObject) ; 

41 EmfEngine engine = new EmfEngine ( emfGraph ) ; 

42 TransformationUnit unit = t s . findUnitByName ( unitName ) ; 

43 Unit Application unitApp = new Unit Application ( engine , 

44 unit); 

45 boolean success = unitApp . execute () ; 

46 if(success){ 

47 saveModel ( unitName + " Result . xmi " , rootObject); 

48 } else { 

49 System . err . println ("' " + unitName 

so + "' could not be applied!"); 

} 

52 }// performlnsertTransitiveEdges 

53 



54 } / / class 



